home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1997 July: Mac OS SDK / Dev.CD Jul 97 SDK1.toast / Development Kits (Disc 1) / Communications Toolbox / CommToolbox 1.1 / Interfaces / CIncludes / CTBUtilities.h < prev    next >
Encoding:
C/C++ Source or Header  |  1994-11-21  |  3.1 KB  |  136 lines  |  [TEXT/MPS ]
  1. /************************************************************
  2.     CTBUtilities.h
  3.     C Interface to the Macintosh Libraries
  4.  
  5.         Copyright Apple Computer, Inc. 1988-1991
  6.         All rights reserved
  7. ************************************************************/
  8.  
  9.  
  10. #ifndef __CTBUTILITIES__
  11. #define __CTBUTILITIES__
  12.  
  13. #ifndef    __MEMORY__
  14. #include <Memory.h>
  15. #endif
  16.  
  17. #ifndef __PACKAGES__
  18. #include <Packages.h>
  19. #endif
  20.  
  21. #ifndef __APPLETALK__
  22. #include <AppleTalk.h>
  23. #endif
  24.  
  25.  
  26. enum {
  27.  
  28.  
  29. /*    version of Comm Toolbox Utilities    */
  30.  curCTBUVersion = 2,
  31.  
  32. /*    Error codes/types    */
  33.  ctbuGenericError = -1,
  34.  ctbuNoErr = 0
  35. };
  36.  
  37. typedef        OSErr    CTBUErr;
  38.  
  39. enum {chooseDisaster = -2,chooseFailed,chooseAborted,chooseOKMinor,chooseOKMajor,
  40.     chooseCancel};
  41. typedef unsigned short ChooseReturnCode;
  42.  
  43. enum {nlOk,nlCancel,nlEject};
  44. typedef unsigned short NuLookupReturnCode;
  45.  
  46. enum {nameInclude = 1,nameDisable,nameReject};
  47. typedef unsigned short NameFilterReturnCode;
  48.  
  49. enum {zoneInclude = 1,zoneDisable,zoneReject};
  50. typedef unsigned short ZoneFilterReturnCode;
  51.  
  52.  
  53. enum {
  54.  
  55.  
  56. /*    Values for hookProc items        */
  57.  hookOK = 1,
  58.  hookCancel = 2,
  59.  hookOutline = 3,
  60.  hookTitle = 4,
  61.  hookItemList = 5,
  62.  hookZoneTitle = 6,
  63.  hookZoneList = 7,
  64.  hookLine = 8,
  65.  hookVersion = 9,
  66.  hookReserved1 = 10,
  67.  hookReserved2 = 11,
  68.  hookReserved3 = 12,
  69.  hookReserved4 = 13,
  70.  
  71. /*    "virtual" hookProc items    */
  72.  hookNull = 100,
  73.  hookItemRefresh = 101,
  74.  hookZoneRefresh = 102,
  75.  hookEject = 103,
  76.  hookPreflight = 104,
  77.  hookPostflight = 105,
  78.  hookKeyBase = 1000
  79. };
  80.  
  81.  
  82. /*    NuLookup structures/constants    */
  83. struct NLTypeEntry {
  84.     Handle hIcon;
  85.     Str32 typeStr;
  86. };
  87.  
  88. typedef struct NLTypeEntry NLTypeEntry;
  89.  
  90.  
  91. typedef NLTypeEntry NLType[4];
  92.  
  93. struct NBPReply {
  94.     EntityName    theEntity;
  95.     AddrBlock    theAddr;
  96. };
  97.  
  98. typedef struct NBPReply NBPReply;
  99.  
  100.  
  101. typedef pascal short (*NameFilterProcPtr)(EntityName theEntity);
  102. typedef pascal short (*ZoneFilterProcPtr)(Str32 theZone);
  103.  
  104. typedef NameFilterProcPtr nameFilterProcPtr;
  105. typedef ZoneFilterProcPtr zoneFilterProcPtr;
  106.  
  107. #ifdef __cplusplus
  108. extern "C" {
  109. #endif
  110. pascal CTBUErr    InitCTBUtilities(void);
  111. pascal short     CTBGetCTBVersion(void);
  112.  
  113.  
  114. pascal short     StandardNBP(Point where,ConstStr255Param prompt,short numTypes,
  115.                     NLType typeList,NameFilterProcPtr nameFilter,ZoneFilterProcPtr zoneFilter,
  116.                     DlgHookProcPtr hookProc,NBPReply *theReply);
  117.  
  118. pascal short     CustomNBP(Point where,ConstStr255Param prompt,short numTypes,
  119.                     NLType typeList,NameFilterProcPtr nameFilter,ZoneFilterProcPtr zoneFilter,
  120.                     DlgHookProcPtr hookProc,long userData,short dialogID,ModalFilterProcPtr filterProc,
  121.                     NBPReply *theReply);
  122.  
  123. /*  Obsolete synonyms for above routines  */
  124. pascal short     NuLookup(Point where,ConstStr255Param prompt,short numTypes,
  125.                     NLType typeList,NameFilterProcPtr nameFilter,ZoneFilterProcPtr zoneFilter,
  126.                     DlgHookProcPtr hookProc,NBPReply *theReply);
  127.  
  128. pascal short     NuPLookup(Point where,ConstStr255Param prompt,short numTypes,
  129.                     NLType typeList,NameFilterProcPtr nameFilter,ZoneFilterProcPtr zoneFilter,
  130.                     DlgHookProcPtr hookProc,long userData,short dialogID,ModalFilterProcPtr filterProc,
  131.                     NBPReply *theReply);
  132. #ifdef __cplusplus
  133. }
  134. #endif
  135.  
  136. #endif